home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / libs / dignet_2_1.lha / dignet / DigNet_2.1.readme < prev    next >
Text File  |  1997-03-12  |  3KB  |  73 lines
  1. Short:    Easy ser network handle for games/progs
  2. Uploader: kenny@bgnett.no (Kenneth "Kenny" Nilsen)
  3. Author:   kenny@bgnett.no (Kenneth "Kenny" Nilsen)
  4. Type:     util/libs 
  5. Requires: kickstart 2.0+
  6. Replaces: util/libs/DigNet*
  7. Version:  2.1
  8.  
  9.  
  10. $VER: dignet.library 2.1 (12.03.97)
  11.  
  12. Copyright (C) 1997 by Digital Surface/Kenneth "Kenny" Nilsen.
  13. All rights reserved.
  14.  
  15.  
  16. NEWS:    - Resource tracking ! Including debug tools that uses this feature.
  17.     - Great speed improvments on ReadNet()/WriteNet()/WriteString()
  18.       You no longer have to read/write bytes to get correct result,
  19.       the routines do it for you which increase the speed ~250%.
  20.       ReadString() still have to work the way it does.
  21.     - Buffer size now defaults to 8 KB buffer instead of 2 KB.
  22.     - Stupid bugs on the ReadString()/WriteString(). Fixed!
  23.  
  24. CHANGES:  - ReadString() now returns -1 instead of 1 if buffer overflow!
  25.       - Cleaned up the autodoc for types/explinations.
  26.  
  27.  
  28. Includes a simple terminal program that uses the dignet.library and take
  29. advantages of the speed improvments in 2.1+. Source and binary included!
  30.  
  31. ----------------------------------------------------------------------------
  32.  
  33. INTRODUCTION
  34.  
  35. Always  wanted to make games or programs that could support serial network ?
  36. This will maybe be the solution for you.  This library will do all the dirty
  37. work  for  you.   All  you need to do is to call read and write functions to
  38. communicate.   No  more hustling with setting up structures, ports and pools
  39. to use the device.  No more DoIO.
  40.  
  41. Tested with duart.device 0 and 1 with nullmodem-cable.  Tested agains modem.
  42. Should work fine with serial.device and compatible devices.  Do not use with
  43. other devices such as trackdisk.device etc.
  44.  
  45. The library functions are fully re-entrant.
  46.  
  47. IMPORTANT:
  48.  
  49. Read the autodoc section /---background--- and ---notes--- for important
  50. notes!
  51.  
  52. Developer files for assembler and C included. Notify me if the C includes
  53. are incomplete, I am not a C guru at all (assembler is fine though ;)
  54.  
  55. This is version 2.1 (still beta). Let me know if you find bugs.
  56. Email me for bugs or comments. I am happy to receive ideas.
  57.  
  58.  
  59. TODO:
  60.  
  61. - SetBaud() function to easily change the baud rate.
  62. - Error code on what type of error (out of memory, device couldn't be opened,
  63.   couldn't allocate port etc.)
  64.  
  65.  
  66. IDEAS:
  67.  
  68. - Functions for modem > sending ATZ/ATDT, parsing OK/RING/CONNECT/NO CARRIER
  69.   etc. Let me know what you think.
  70. - Resource tracker for program using the library (clean up device(s) if
  71.   program crashes)
  72.  
  73.